InBox TelegramNotification
Versão 6.1.0
Criação 28/04/2020
Recursos
O módulo envia notificações para o Telegram de números cadastrados no atendente e no usuário cliente.
Pré-requisitos
Framework
As seguintes versões de framework OTRS são suportadas:
- [6.x.x]
Módulos
Os seguintes módulos são requeridos:
- InBox Core 6.27.7 ou superior
Sistema Operacional
Os seguintes sistemas operacionais são requeridos:
- [Nenhum]
Software de Terceiros
Os seguintes softwares de terceiros são requeridos:
- [WWW::Telegram::BotAPI v0.12]
Instalação
bin/otrs.Console.pl Admin::Package::Install /path/to/InBox\ TelegramNotification 6.1.0.opm
Configuração
Este módulo deve ser configurado via Configuração do Sistema na interface administrativa. As seguintes opções de configurações estão disponíveis:
Instalar o software de terceiro WWW::Telegram::BotAPI v0.12
Instalar via terminal o software através do comando abaixo:
cpan WWW::Telegram::BotAPI
Criar o bot no telegram
Acessar o telegram pesquisar por BotFather e seguir os passos para criação do bot:
Inserir o Token do Telegram bot
Ao criar o bot é gerado um token para acessar a API, e o mesmo deve ser inserido na config:
Telegram::Config::Token
Configurar as Notificações de chamado
Ao criar a notificação é preciso selecionar um evento que irá disparar a notificação.
E Habilitar o envio de notificação via Telegram:
A seleção de usuários para envio de notificação podem ser feitas de duas formas:
Através da configuração Destinatários:
E através do campo Destinatários Adicionais, é possível inserir mais de um número separados por virgula:
Obs.: Todos os números devem estar no padrão internacional e devem ter o sinal "+" no código do país. Exemplo: (+55), o DDD local (11). Os números cadastrados no campo Destinatários adicionais não podem coincidir com o telefone dos Clientes nem dos Atendentes.
Configurar a notificação que será enviada
Na notificação de texto, é preciso configurar as TAG's com as informações necessárias que serão encaminhadas via Telegram:
obs: Para que a notificação seja enviada, Os numeros do cliente não podem coincidir com os numeros dos atendentes e vice versa.
Configurando o Telegram
Para configurar o Telegram basta iniciar o bot, que irá solicitar o compartilhamento do telefone para verificar se o usuário está cadastrado para receber as notificações.
Iniciando o bot:
Será solicitado o compartilhamento do número do telefone:
Enviando notificação para o Telegram
Com as configurações finalizadas, sempre que o evento for acionado, as notificação serão encaminhadas para os destinatários.
Como exemplo o evento disparado foi atualização de fila:
Ao ser disparado o evento a Notificação foi encaminhada para o destinatário: